<div id="Tagging-by-date_002ftag"></div>
<div class="header">
<p>
Next: [[cvs: Deleting, moving, and renaming tags#Deleting, moving, and renaming tags|Modifying tags]], Previous: [[cvs: Specifying what to tag from the working directory#Specifying what to tag from the working directory|Tagging the working directory]], Up: [[cvs: Revisions#Revisions|Revisions]] &nbsp; |[[cvs: Index#SEC_Contents|Contents]]||[[cvs: Index#Index|Index]]|</p>
</div>

----

<div id="Specifying-what-to-tag-by-date-or-revision"></div>
=== Specifying what to tag by date or revision ===
<div id="index-rtag-_0028subcommand_0029"></div>

The <code>cvs rtag</code> command tags the repository as of a
certain date or time (or can be used to tag the latest
revision).  <code>rtag</code> works directly on the
repository contents (it requires no prior checkout and
does not look for a working directory).

The following options specify which date or revision to
tag.  See [[cvs: Common command options#Common command options|Common options]], for a complete
description of them.

;<code>-D <var>date</var></code>
: Tag the most recent revision no later than <var>date</var>.

;<code>-f</code>
: Only useful with the &lsquo;<code>-D <var>date</var></code>&rsquo; or &lsquo;<code>-r <var>tag</var></code>&rsquo; flags.  If no matching revision is found, use the most recent revision (instead of ignoring the file).

;<code>-r <var>tag</var></code>
: Only tag those files that contain existing tag <var>tag</var>.

The <code>cvs tag</code> command also allows one to specify
files by revision or date, using the same &lsquo;<code>-r</code>&rsquo;,
&lsquo;<code>-D</code>&rsquo;, and &lsquo;<code>-f</code>&rsquo; options.  However, this
feature is probably not what you want.  The reason is
that <code>cvs tag</code> chooses which files to tag based on
the files that exist in the working directory, rather
than the files which existed as of the given tag/date.
Therefore, you are generally better off using <code>cvs
rtag</code>.  The exceptions might be cases like:

<div class="example" style="margin-left: 3.2em">
 cvs tag -r 1.4 stable backend.c
</div>

This document was generated on <i>a sunny day</i> using [http://www.nongnu.org/texi2html/ <i>texi2html</i>].
